home *** CD-ROM | disk | FTP | other *** search
/ IRIX Base Documentation 2001 May / SGI IRIX Base Documentation 2001 May.iso / usr / share / catman / p_man / cat2 / standard / getjusage.z / getjusage
Encoding:
Text File  |  2001-04-17  |  2.9 KB  |  67 lines
  1.  
  2.  
  3.  
  4. ggggeeeettttjjjjuuuussssaaaaggggeeee((((2222))))                                                      ggggeeeettttjjjjuuuussssaaaaggggeeee((((2222))))
  5.  
  6.  
  7.  
  8. NNNNAAAAMMMMEEEE
  9.      getjusage - get job usage information
  10.  
  11. SSSSYYYYNNNNOOOOPPPPSSSSIIIISSSS
  12.      ####iiiinnnncccclllluuuuddddeeee <<<<ssssyyyyssss////rrrreeeessssoooouuuurrrrcccceeee....hhhh>>>>
  13.  
  14.      iiiinnnntttt ggggeeeettttjjjjuuuussssaaaaggggeeee((((jjjjiiiidddd____tttt jjjjiiiidddd,,,, iiiinnnntttt rrrreeeessssoooouuuurrrrcccceeee,,,, ssssttttrrrruuuucccctttt jjjjoooobbbb rrrruuuussssaaaaggggeeee ****uuuupppp))))
  15.  
  16. DDDDEEEESSSSCCCCRRRRIIIIPPPPTTTTIIIIOOOONNNN
  17.      The _g_e_t_j_u_s_a_g_e function retrieves the resource usage values for the
  18.      specified job ID.  If the _j_i_d parameter is zero, usage values for the
  19.      current job will be returned.  If _j_i_d is non-zero, it represents the job
  20.      ID of the job for which usages values are retrieved.  The _r_e_s_o_u_r_c_e
  21.      parameter specifies the resource for which the usage values are returned.
  22.      Allowable values are taken from the JLIMIT_xxx macros found in the
  23.      ssssyyyyssss////rrrreeeessssoooouuuurrrrcccceeee....hhhh file.  For example, the JLIMIT_CPU macro is for cpu time.
  24.      The _u_p parameter points to a _r_u_s_a_g_e structure in the user program where
  25.      the usage values will be returned.
  26.  
  27.      If the current job ID is different from the job ID being requested, the
  28.      _g_e_t_j_u_s_a_g_e function checks for the CAP_MAC_READ capability.  See the
  29.      capability(4) and capabilities(4) man pages for more information on the
  30.      capability mechanism that provides fine grained control over the
  31.      privileges of a process.
  32.  
  33. EEEERRRRRRRROOOORRRRSSSS
  34.      Under the following conditions, the _gggg_eeee_tttt_jjjj_uuuu_ssss_aaaa_gggg_eeee function fails and sets
  35.      _e_r_r_n_o to:
  36.  
  37.      [ENOPKG]       The job limits software is not installed.
  38.  
  39.      [ENOJOB]       A job with the specified job ID cannot be found.
  40.  
  41. SSSSEEEEEEEE AAAALLLLSSSSOOOO
  42.      getjlimit(2), getrusage(3).
  43.  
  44. DDDDIIIIAAAAGGGGNNNNOOOOSSSSTTTTIIIICCCCSSSS
  45.      Upon successful completion, _g_e_t_j_u_s_a_g_e returns a value of 0.  Otherwise, a
  46.      value of -1 is returned and eeeerrrrrrrrnnnnoooo is set to indicate the error.
  47.  
  48.  
  49.  
  50.  
  51.  
  52.  
  53.  
  54.  
  55.  
  56.  
  57.  
  58.  
  59.  
  60.  
  61.  
  62.  
  63.                                                                         PPPPaaaaggggeeee 1111
  64.  
  65.  
  66.  
  67.